home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / INTERNET / BROWSERS / WWW131.ZIP / WWW131 / CAB / DOC / CAB_E.TXT < prev    next >
Encoding:
Text File  |  1996-05-29  |  38.9 KB  |  1,194 lines

  1.                          The documentation to
  2.  
  3.                                  CAB
  4.  
  5.                              Version 1.3
  6.                               26.05.1996
  7.  
  8.                                   by
  9.  
  10.                            Alexander Clauss
  11.                          Stresemannstra₧e 44
  12.                           D-64297 Darmstadt
  13.  
  14.                 aclauss@rbg.informatik.th-darmstadt.de
  15.  
  16.  
  17.  
  18. Contents
  19. ========
  20.  
  21.  1 A short introduction
  22.  
  23.  2 Legal
  24.  
  25.  3 Address
  26.  
  27.  4 System requirements
  28.  
  29.  5 Installation
  30.  
  31.  6 Navigating HTML Documents
  32.  
  33.  7 Module for on-line Internet access
  34.  
  35.  8 Description of menu items
  36.    8.1 Open URL...
  37.    8.2 Open local...
  38.    8.3 Reload
  39.    8.4 Print
  40.    8.5 New window
  41.    8.6 Close window
  42.    8.7 View source
  43.    8.8 Quit
  44.    8.9 Home page
  45.    8.10 Back
  46.    8.11 Find keyword
  47.    8.12 Hotlist
  48.    8.13 Document -> Hotlist
  49.    8.14 General options
  50.    8.15 Display
  51.    8.16 Font selection
  52.    8.17 External viewers
  53.    8.18 Paths...
  54.    8.19 Cache
  55.    8.20 Save options
  56.  
  57.  9 Button bar
  58.  
  59. 10 Thanks
  60.  
  61. 11 Possible future updates
  62.  
  63. 12 History
  64.  
  65.  
  66.  
  67. 1 A short introduction
  68. ======================
  69.  
  70. *CAB* - The Taxi to the information highway!
  71. *CAB* - Crystal Atari Browser
  72.  
  73. Formerly called HTML-Browser
  74.  
  75. This browser is capable of reading HTML format documents. The HTML
  76. documents could be on disk or CD. Reading pages on-line to an
  77. Internet World Wide Web (WWW) site requires a separate module.
  78.  
  79.  
  80.  
  81. 2 Legal
  82. =======
  83.  
  84. CAB (HTML-Browser) is FREEWARE. It may be copied and used freely.
  85. Distribution by BBSs and PD libraries is allowed. However, CAB (HTML-
  86. Browser) may NOT under ANY circumstances be included in CD-ROM
  87. collections or on magazine cover disks without my prior written
  88. permission. CAB (HTML-Browser) and its documentation must always
  89. remain together and complete with all its files and documentation.
  90. Changes to the program and/or documentation is forbidden.
  91.  
  92. If you like CAB (HTML-Browser) and you use it regularly, please
  93. register your copy, any currency is welcome.
  94.  
  95. If you would like to see this program developed please send some
  96. feedback and register your copy. UK, USA users can take advantage of
  97. local support, refer to SUPPORT.TXT for more details. No feedback
  98. means no development, it's that simple!
  99.  
  100.  
  101.  
  102. 3 Address
  103. =========
  104.  
  105. *My address:*
  106.  
  107.     Alexander Clauss
  108.     Stresemannstr. 44
  109.     D-64297 Darmstadt
  110.     Germany
  111.  
  112.     email: aclauss@rbg.informatik.th-darmstadt.de
  113.     WWW: http://www.student.informatik.th-darmstadt.de/~aclauss/
  114.  
  115. *Banking arrangements:*
  116.  
  117.     Sparkasse Darmstadt
  118.     BLZ: 508 501 50
  119.     Kontonr: 0115032143
  120.  
  121. *UK support:*
  122.  
  123.     Joe Connor
  124.     65 Mill Road
  125.     Colchester
  126.     CO4 5LJ
  127.     England
  128.  
  129.     email: jconnor@cix.compulink.co.uk
  130.  
  131. *USA, Canada support:*
  132.  
  133. Jeff Wisniewski
  134. P.O. Box 1243
  135. Newtown, PA 18940-0871
  136.  
  137. email: jeffrey.wisniewski@microserve.com
  138.  
  139. *France support:*
  140.  
  141.     Jouffrey Romuald
  142.     1 chemin de l'église
  143.     38100 GRENOBLE
  144.  
  145.     email: rom38@gen4.pressimage.fr
  146.  
  147.  
  148.  
  149. 4 System requirements
  150. =====================
  151.  
  152. The program runs on any computer using the (Atari-) TOS operating
  153. system with 1Mb or more memory. The memory requirements for images
  154. depends on the colour depth. The greater the colour depth the more
  155. memory required. Using a True colour graphic card (24 or 32 bit)
  156. gobbles up memory and you're likely to need considerably more than
  157. 1Mb.
  158.  
  159. CAB is resolution independent with two limitations: At 320x200 (ST-
  160. low) not all of the dialogs fit entirely on screen, at 640x200 (ST-
  161. Medium) the screen display is distorted (half height). Consequently
  162. we recommend using CAB at resolutions of 640x400 (ST-high) or higher
  163. with any number of colours, a multitasking environment (e.g MagiC,
  164. Geneva etc) is also desirable.
  165.  
  166. Although not absolutely necessary the use of vector fonts via NVDI
  167. v3.x or SpeedoGDOS is recommended. The system font or bitmap GDOS
  168. fonts can however be used if required.
  169.  
  170.  
  171.  
  172. 5 Installation
  173. ==============
  174.  
  175. *Attention:*
  176.  
  177.     Since v1.0 the program can no longer be installed as a desktop
  178.     accessory.
  179.  
  180.     Configuration files from older versions of CAB (CAB.INF) cannot
  181.     be used. Unfortunately you'll have to reset your settings
  182.     manually.
  183.  
  184.     The format of the Hotlist file has also been altered but unless a
  185.     file in the new format is available the old Hotlist file
  186.     (CAB.HOT) is loaded. The new Hotlist file is called hotlist.html.
  187.     As soon as the Hotlist has been saved in the new format the old
  188.     file (CAB.HOT) can safely be deleted.
  189.  
  190. HTML files downloaded from WWW sites often include long filenames
  191. which can easily result in duplication of filenames using the basic
  192. TOS 8+3 character file system. It's well worth setting up a Minix
  193. hard disk partition or other file system which supports long
  194. filenames to handle HTML files.
  195.  
  196. The CAB distribution is supplied ready to run once unarchived onto
  197. your working disk but you should still review the settings in the
  198. Options menu and configure the options to suit your needs.
  199.  
  200.  
  201.  
  202. 6 Navigating HTML Documents
  203. ===========================
  204.  
  205. Click on any underlined keyword to branch to the new page. Press the
  206. [Undo] key to step to return to the previous page. Clicking on a link
  207. using the right mouse button will display the address of the page it
  208. links to.
  209.  
  210.  
  211.  
  212. 7 Module for on-line Internet access
  213. ====================================
  214.  
  215. To browse WWW pages on-line to the Internet a further module
  216. (CAB.OVL) is needed. This module should be copied to the same
  217. directory as CAB.APP. This file contains the additional routines
  218. needed to access the Internet.
  219.  
  220. On Minix partitions the x-flag of the CAB.OVL file must be set
  221. otherwise the modul can not be started.
  222.  
  223. I'm not able to test an Internet module but have built an interface
  224. into CAB (HTML-Browser) to enable anyone capable of programming these
  225. routines to create an on-line module. The description of this
  226. interface is available on request and is available as commented C or
  227. Pascal source. I'd like to hear from anyone who programs an on-line
  228. module and would like a copy to distribute with CAB (HTML-Browser)...
  229.  
  230.  
  231.  
  232. 8 Description of menu items
  233. ===========================
  234.  
  235.  
  236. 8.1 Open URL...
  237. ---------------
  238.  
  239. The *Open URL...* option in the *File* menu displays the URL dialog
  240. containing any URL (Universal Resource Locator) addresses you have
  241. set up to access the WWW.
  242.  
  243.  
  244. 8.2 Open local...
  245. -----------------
  246.  
  247. The *Open local* option in the *File* menu calls the file selector which
  248. can be used to open any HTML document from hard disk or CD-ROM.
  249.  
  250. Any file types can be selected. HTML, XBM and GIF files are normally
  251. displayed by CAB (HTML-Browser) with other file types handled by
  252. external programs. Refer to *External programs* for more details.
  253.  
  254. If a folder is selected the contents of the folder and sub
  255. directories are displayed graphically as an HTML page and any files
  256. and folders can be selected using the mouse!
  257.  
  258.  
  259. 8.3 Reload
  260. ----------
  261.  
  262. Reloads the HTML page again. This function is useful (in a
  263. multitasking environment) for editing HTML pages in an editor with
  264. CAB running parallel to display the pages.
  265.  
  266. If the page originated from the WWW using *Reload* will fetch the page
  267. from the WWW again -even if a copy is available in the cache.
  268.  
  269.  
  270. 8.4 Print
  271. ---------
  272.  
  273. If GDOS is available the document in the topped window can be output
  274. as text. Bitmap fonts require matching screen and printer fonts
  275. whereas vector fonts under NVDI 3.x or SpeedoGDOS are automatically
  276. scaled as required.
  277.  
  278. In the dialog the margins can be set. These are in addition to any
  279. offsets or margins attributable to either the printer or GDOS driver.
  280. A popdown menu offers selection between any installed GDOS driver
  281. including, so long as a suitable GDOS driver is available, GEM
  282. Metafile (*.GEM) or bit image (*.IMG).
  283.  
  284. Successful image output relies on the GDOS printer driver supporting
  285. a particular VDI function which may or may not be implemented in the
  286. active driver. We recommend you try printing with images turned on
  287. and if it doesn't work simply turn the option off for subsequent
  288. output. If you're using a dot matrix printer activate the option to
  289. lighten images otherwise the printed output is likely to be too dark.
  290.  
  291.  
  292. 8.5 New window
  293. --------------
  294.  
  295. Opens a new window displaying the contents of the previously topped
  296. window.
  297.  
  298.  
  299. 8.6 Close window
  300. ----------------
  301.  
  302. Closes the window.
  303.  
  304.  
  305. 8.7 View source
  306. ---------------
  307.  
  308. Displays the source text of the displayed HTML document. Also refer
  309. to the *External programs* menu option.
  310.  
  311.  
  312. 8.8 Quit
  313. --------
  314.  
  315. Exits the program.
  316.  
  317.  
  318. 8.9 Home page
  319. -------------
  320.  
  321. This menu option displays the home page, if available.
  322.  
  323. CAB tries to load the home page directly. Anyone who understands HTML
  324. syntax can easily set any page as the home page and create a page to
  325. reference other HTML documents. The file used as the home page can be
  326. set in the *General options* dialog.
  327.  
  328.  
  329. 8.10 Back
  330. ---------
  331.  
  332. Displays the previous document.
  333.  
  334.  
  335. 8.11 Find keyword
  336. -----------------
  337.  
  338. This allows the user to perform a search for keywords in HTML files,
  339. and can optionally be case sensitive. The search can be conducted
  340. over one of the following ranges of documents:
  341.  
  342.   1. Current document only. The text is searched for in the current
  343.      document (the top window). If the text is found the window is
  344.      scrolled so the text is displayed at the top of the window.
  345.  
  346.   2. Local HTML Documents. The text is searched for in all local HTML
  347.      documents contained in the paths specified in the *Paths* dialog
  348.      box (and their subdirectories). The files that contain the text
  349.      is made into a list of links in an HTML file called result.html.
  350.  
  351.      At the moment the HTML files searched by method two are searched
  352.      purely as text, so hidden text such as comments, HTML commands,
  353.      links and so are also found. Processing the files to ignore
  354.      hidden text would be very time costly. This also means that
  355.      special characters such as accents and so on which are written
  356.      into HTML code using commands like ä are not found. This
  357.      shortcoming may be addressed in a future version.
  358.  
  359.      Another tip: If you're searching for something which is often
  360.      used in HTML code as a command or URL-address placing a space
  361.      before it may make it less likely to turn up in commands or URL
  362.      addresses..
  363.  
  364.      For example: Searching for the text 'WWW' often matches
  365.      subdirectories and addresses for pages in the form
  366.      '.../WWW/foo.html...'. Placing a space before it in the search
  367.      string, ' WWW' removes these occurences resulting in a better
  368.      targetted search. These don't apply to methods 1) and 3)!
  369.  
  370.   3. In the c't-CDROM Database. This option is only useful for people
  371.      with the c't-CDROM (the 1994 (or 92/93) c't magazines in HTML
  372.      format)!
  373.  
  374.      In this case the HTML files themselves aren't searched, but the
  375.      index file on the CD is accessed instead. So that HTML-Browser
  376.      knows where the files for this CD are kept are, you need to fill
  377.      in the appropriate section of the *Paths* dialog box - the HTML
  378.      documents (in \HTML which also contains the file DEFAULT.HTML)
  379.      and the index database (\UNIX\CT94.DAT or \UNIX\CT9293.DAT). As
  380.      in the previous method, matching documents are made into an HTML
  381.      document called results.html which is then opened.
  382.  
  383.  
  384. 8.12 Hotlist
  385. ------------
  386.  
  387. The hotlist is a list of your most used HTML documents. This list
  388. enables you to get quickly to you favourite pages, without having to
  389. navigate through a long series of pages to get there.
  390.  
  391. The hotlist is divided into themed areas. Using the popup at the top
  392. of the dialog it's easy to switch between different themes.
  393.  
  394. *The 'Theme...' popup:*
  395.  
  396.  *Change theme:* Changes the name of the current theme area. The
  397.     /Miscellaneous/ area cannot be renamed.
  398.  
  399.  *New theme:* Creates a new theme area.
  400.  
  401.  *Delete theme:* Delete the current theme area. The /Miscellaneous/ area
  402.     cannot be deleted. All remaining entries in a deleted theme area
  403.     are moved to the /Miscellaneous/ theme area.
  404.  
  405. *The 'New theme...' popup:*
  406.  
  407.     Using this option a selected entry can be moved to another theme
  408.     area.
  409.  
  410. *The 'Document...' popup:*
  411.  
  412.  *Delete entry:* Deletes the selected entry.
  413.  
  414.  *Change entry:* Changes the selected entry. Annotations to the page
  415.     can also be made.
  416.  
  417.  *Open document:* Opens a document.
  418.  
  419.  *Add current doc:* Copies the current document to the Hotlist.
  420.  
  421. Double clicking on an entry opens the document.
  422.  
  423. The Hotlist is saved to disk as a normal HTML document which provides
  424. an easy way for anyone not familiar with HTML syntax to create their
  425. own home page.
  426.  
  427.  
  428. 8.13 Document -> Hotlist
  429. ------------------------
  430.  
  431. The current document is inserted in the Hotlist provided it's not
  432. already listed. It will be filed away in the /Miscellaneous/ theme
  433. area.
  434.  
  435.  
  436. 8.14 General options
  437. --------------------
  438.  
  439.  *Home page:* After launching CAB or by selecting the *Home page* menu
  440.     entry the specified HTML file will be displayed. Often it's
  441.     useful to create a home page containing references to frequently
  442.     used HTML pages. By default CAB attempts to load home.html as the
  443.     home page although any page can be set to be the home page
  444.     -simply enter the URL address. If the file is located in the
  445.     specified start directory for CAB.APP you can select the *Start
  446.     folder* button and using the *Search* button select the desired file
  447.     using the file selector.
  448.  
  449.  *Popup menus:* CAB provides a row of popup menus to relieve the tedium
  450.     of navigating through HTML pages. Basic principle:
  451.  
  452.       ∙ Left click on a reference to branch to the corresponding
  453.         page.
  454.  
  455.       ∙ Right click on a reference to display the destination of the
  456.         reference.
  457.  
  458.       ∙ Click on the window background (not on a reference) to
  459.         display further popup menus.
  460.  
  461.     You can set which menu will be displayed using the left and right
  462.     mouse clicks (with and without holding down the [Shift] key). The
  463.     following popup menus are available:
  464.  
  465.      *History:* Lists the previously displayed documents.
  466.  
  467.      *References:* Lists the references in the current document.
  468.  
  469.      *Menu:* Lists some menu items.
  470.  
  471.  *Miscellaneous:* During loading, formatting and data transfer from the
  472.     Internet CAB displays a series of reports in a windowed dialog
  473.     (if the option *Dialog for Status messages* is active) otherwise
  474.     the window info line is used instead. The display in the window
  475.     info line has a couple of disadvantages. First a window may not
  476.     be open to display the information and secondly the dialog
  477.     displays the information more clearly. On the other hand using
  478.     the window info line allows a document in the window can be read
  479.     and scrolled while the text is still being formatted.
  480.  
  481.     The *load index.html automatically* only has an affect on local
  482.     references (ie to files/directories on your drive) If the
  483.     reference points to a directory on a drive the contents will be
  484.     displayed unless a file index.html exists in which case this is
  485.     loaded instead. On use for index.html is to set up a page
  486.     containing an index of all your favourite documents.
  487.  
  488.  
  489. 8.15 Display
  490. ------------
  491.  
  492. In this dialog you can configure various display options for HTML
  493. documents.
  494.  
  495.  *Colours:* This section allows you to configure the display colours,
  496.     for the foreground text, the background colour and link colour.
  497.     If you're using less than 16 colours, the window background will
  498.     always be white regardless of the settings here. In 16 colour
  499.     mode, only the first nine colours should be used as the last 7
  500.     may be changed for pictures etc. In more than 16 colours, any of
  501.     the first 16 can be used as they will not be changed.
  502.  
  503.     Some HTML documents include information about which colours
  504.     should be used for text, references and the window background.
  505.     The option *Use guidelines in document* tells CAB to use this
  506.     information (if available).
  507.  
  508.  *Links:* Links can be displayed in underlined and/or bold text (this
  509.     is important for monochrome systems which can't distinguish links
  510.     by colour).
  511.  
  512.  *Images:* Controls image display.
  513.  
  514.      *Don't show* Prevents images being loaded and displayed which
  515.         speeds up page loading.
  516.  
  517.      *Monochrome* Images are displayed in monochrome using dithering.
  518.         It's the quickest method but this obviously the quality
  519.         suffers.
  520.  
  521.      *Greyscale* Images are displayed as greyscales. Higher quality
  522.         display at the expense of speed.
  523.  
  524.      *Colour* Images are displayed in colour depending on the hardware
  525.         available:
  526.  
  527.          ∙ 4-8 bitplanes (16-256 colours). Images are dithered if the
  528.            number of colours available is less than the number of
  529.            colours contained in the image. In 16 colour modes
  530.            greyscale display is often more suitable.
  531.  
  532.          ∙ 15/16 bit Highcolor (32768/65536 colours) eg Falcon
  533.            Truecolor mode
  534.  
  535.          ∙ 24 or 32 bit Truecolor (16.7 million colours)
  536.  
  537.      *Text instead of images* The HTML language provides for text only
  538.         systems by allowing images to be accompanied by some text
  539.         which is displayed instead of the image. This enables WWW
  540.         Browsers which cannot display images to display text output
  541.         instead. If this option is active (crossed) only images for
  542.         which no alternative text is available are displayed as
  543.         images.
  544.  
  545.  *Text width:* Text can either be formatted at a fixed width or
  546.     justified to fit the window width. Text justified to fit the
  547.     window width looks better but takes longer to display as the text
  548.     must be reformatted.
  549.  
  550.  
  551. 8.16 Font selection
  552. -------------------
  553.  
  554. Wherever possible CAB (HTML-Browser) uses different fonts and point
  555. sizes to display HTML files. Optimal output quality is provided using
  556. vector fonts for which you'll need to install either NVDI v3.x or
  557. SpeedoGDOS. Normal bitmap fonts can be used but they're not nearly as
  558. nice.
  559.  
  560. Next you need to tell CAB (HTML-Browser) which (GDOS) fonts to use
  561. for each corresponding style in an HTML document. Vector fonts as
  562. provided by SpeedoGDOS or NVDI 3.x are recommended. You must specify
  563. three fonts (sans-serif, serif and monospaced) in four different
  564. styles (normal, bold, italic and bold and italic) making twelve
  565. selections altogether.
  566.  
  567. For the bold and italic settings you should use a 'real' bold or
  568. italic font wherever possible. If you don't have one available you'll
  569. have to simulate these text effects using the corresponding buttons
  570. adjacent to the font selection popup. If you're using vector fonts
  571. then use the appropriate font from the font family, if available.
  572.  
  573. Some commands such as <PRE>...</PRE>, <FORM>...</FORM> etc will cause
  574. display format problems with /proportional/ fonts. To avoid these
  575. problems only use *non-proportional* fonts for *preformatted* text.
  576.  
  577. The supplied INF file has the following presets (for NVDI 3.x):
  578.  
  579.  *Headings:* Swiss 721 (normal, bold, italic, bold+italic)
  580.  
  581.  *Normal text:* Dutch 801 (normal, bold, italic, bold+italic)
  582.  
  583.  *Formatted:* Letter Gothic 12 Pitch (normal, bold, italic,
  584.     bold+italic)
  585.  
  586. If you don't like or haven't got these fonts, you'll have to select
  587. alternatives.
  588.  
  589. The size of the body text can also be altered. Don't make this too
  590. large or too small! Somewhere between 10 and 13 point is sensible (I
  591. use 12 point).
  592.  
  593. If you haven't got access to vector fonts (i.e. you don't own a copy
  594. of NVDI 3.x or SpeedoGDOS) then the point size won't change, but the
  595. text can still be viewed using the system font, usually 10 point.
  596.  
  597.  
  598. 8.17 External viewers
  599. ---------------------
  600.  
  601. If a link in an HTML document points to a file which is not in HTML
  602. format, an external viewer can be called. These programs can be
  603. called in one of two ways and are configurable via the *External
  604. programs...* dialog via the *Options* menu.
  605.  
  606. Individual file types can be assigned to different programs. File
  607. extensions are entered into the *Files* field. Several extensions can
  608. be entered using a comma to separate each entry.
  609.  
  610. Programs are selected by clicking on the selection box to the right
  611. of the *Files* field which displays the file selector to select the
  612. desired viewer.
  613.  
  614. Finally each entry includes a *Supports VA_START* checkbox which should
  615. be crossed if the viewer understands the VA_START message so CAB can
  616. send a VA_START message to the viewer so the file can be viewed with
  617. re-launching the viewer.
  618.  
  619. The *Default* program (*.*) is called to display any files for which no
  620. program has been assigned.
  621.  
  622. If one of more extensions have been defined without a program
  623. assigned CAB attempts to display the file. This is only sensible for
  624. *.gif, *.xbm, *.htm and ASCII files (for example: *.txt, *.doc, *.c,
  625. *.pas, *.tex etc...) for which CAB (HTML-Browser) includes built-in
  626. display routines. When any non ASCII format file is encountered CAB
  627. displays the file selector using which a copy of the file to be saved
  628. to any desired location.
  629.  
  630. The current HTML page can be displayed as source text by selecting an
  631. application in the *Source* entry. This application is called via the
  632. menu entry *View source...*. If no application has been assigned the
  633. *Default* program is called instead.
  634.  
  635. Double clicking on the *program path* boxes opens a further dialog with
  636. an option to clear the current path.
  637.  
  638. Some suggested external programs:
  639.  
  640.  *.text,txt:     ST-Guide, 1st-Guide (or none, then HTML.APP is used)
  641.  
  642.  *.mpeg,mpg,mpe: 1st-Guide (on a Falcon under Single TOS the fast DSP
  643.                  MPEG player is recommeded)
  644.  
  645.  *.jpeg,jpg,jpe: 1st-Guide, GEMview
  646.  
  647.  *.tiff,tif:     GEMview, Imagecopy
  648.  
  649.  *.gif,xbm:      GEMview, Imagecopy (or none, then HTML.APP is used)
  650.  
  651.  *.dvi:          DVI display included in TeX archives
  652.  
  653.  *.* (Default):  GEMview (or other program which handles as many
  654.                  formats as possible)
  655.  
  656.  *.html,htm:     ST-Guide, 1st-Guide, (or and editor so the HTML
  657.                  source can be edited)
  658.  
  659.  
  660. 8.18 Paths...
  661. -------------
  662.  
  663. If you have a copy of the c't ROM '94 (or 92/93) (CD containing the
  664. contents of the German magazine c't) then set the path for the field
  665. c't CDROM.
  666.  
  667. In the *HTML folder* field set the directory which contains the file
  668. DEFAULT.HTM on the CD (eg ?:\HTML\, where ? is replaced with the
  669. drive letter of your CD-ROM drive). In the *Database* field set the
  670. path to the contents of the CD (?:\UNIX\CT94.DAT (or
  671. ?:\UNIX\CT9293.DAT), again ? is the CD-ROM drive letter).
  672.  
  673. If you want to use CAB online to an Internet WWW site you should set
  674. the *Cache folder* where all files downloaded from the Internet can be
  675. stored. Ideally this folder should be on a Minix hard disk partition,
  676. or other file system which supports long filenames to handle HTML
  677. files because HTML files downloaded from WWW sites often include long
  678. filenames which can easily result in duplication of filenames using
  679. the basic TOS 8+3 character file system -and make sure the partition
  680. has plenty of room!
  681.  
  682. In *HTML folders* you can enter the paths CAB (HTML-Browser) looks to
  683. find HTML files.
  684.  
  685. HTML files contain absolute local paths (eg /path/file.html) which
  686. can soon turn the root directory of your partition into choas. The
  687. HTML folders help avoid this by telling HTML-Browser to look for HTML
  688. files in the folders specified.
  689.  
  690. Here's an example:
  691.  
  692.  *Entered HTML folders:*
  693.  
  694.       ∙ F:\HTML.DOC\
  695.  
  696.       ∙ G:\VARIOUS\
  697.  
  698.  *Current drive:* F:\
  699.  
  700.  *Path in HTML file:*
  701.  
  702.       ∙ /example/text/index.html
  703.  
  704.  *Where CAB looks:*
  705.  
  706.       1. F:\example\text\index.html
  707.  
  708.       2. F:\HTML.DOC\example\text\index.html
  709.  
  710.       3. G:\VARIOUS\example\text\index.html
  711.  
  712. Double clicking on the *program path* boxes opens a further dialog with
  713. an option to clear the current path.
  714.  
  715.  
  716. 8.19 Cache
  717. ----------
  718.  
  719. CAB (HTML-Browser) uses two caches to maximise the display of files.
  720.  
  721. The *Image cache* is used to avoid repeated unpacking and dithering
  722. which both take a great deal of processing time. Images no longer
  723. displayed are held in memory (RAM) in case they are needed again.
  724. Naturally this takes memory so the maximum size of the cache can be
  725. set in the *Maximum size* field. If the cache becomes full the least
  726. used image is purged from the cache to free up more space. Using the
  727. *Keep free* option it's also possible to set the minimim amount of
  728. memory free for other applications. The cache can also be manually
  729. purged using the *Free cache* button which can be useful to quickly
  730. free up more memory for another application under a multitasking OS.
  731. The cache remains empty until further images are displayed in CAB
  732. (HTML-Browser).
  733.  
  734. *Attention*
  735.  
  736.     The actual memory consumption for the Cache can be higher than
  737.     entered in the dialog.
  738.  
  739. The *Internet Cache* is used to store files downloaded from the
  740. Internet on your disk to avoid repeatedly downloading the same files
  741. from the Internet if they're viewed more than once. See also *Paths*
  742.  
  743. The *Maximum size* and *Keep free* options limit the amount of disk space
  744. used by the cache and CAB (HTML-Browser) will purge the oldest files
  745. from the cache to maintain the cache within the defined limits.
  746.  
  747. If the *Delete after 'quit'* option is active (crossed) the files in
  748. the cache will be deleted on exiting CAB (HTML-Browser). Naturally
  749. unless disk space is limited or you're sure you'll never need the
  750. files again it's best to keep the files.
  751.  
  752. The *Free cache* button is for emergency use in case you need extra
  753. disk space fast! Only files placed in the the cache directory placed
  754. there by CAB (HTML-Browser) will be deleted.
  755.  
  756.  
  757. 8.20 Save options
  758. -----------------
  759.  
  760. Save the current settings
  761.  
  762.  
  763.  
  764. 9 Button bar
  765. ============
  766.  
  767. Each CAB window contains a button bar which provides an easy way to
  768. access some of the more important functions:
  769.  
  770.  *Back* Displays the previous document
  771.  
  772.  *Home* Displays the home page
  773.  
  774.  *URL* Select a document from a URL address
  775.  
  776.  *File* Select a file using the file selector
  777.  
  778.  *Source* Displays the source text of the currently displayed document
  779.  
  780.  *New* Reloads the current document again
  781.  
  782.  *Hotlist* Displays the hotlist dialog
  783.  
  784. If a 'sad' smiley appears to the right of the buttons it means the
  785. displayed document is faulty in some way. Click on to the smiley to
  786. display detailed error information. This is a particularly useful
  787. option for anyone using CAB to author HTML pages. Only errors which
  788. CAB can determine without wasting disk space or processing time will
  789. be reported.
  790.  
  791. Faulty documents are not neccessarily displayed incorrectly in CAB
  792. but may well exhibit display problems in other browsers (e.g. Mosaic,
  793. Netscape, WebExplorer etc) may not display the document as you
  794. intended.
  795.  
  796.  
  797.  
  798. 10 Thanks
  799. =========
  800.  
  801. I'd like to thank everyone who through their praise, criticism,
  802. suggestions and bug reports have helped in the development of CAB
  803. (HTML-Browser). In particular the following people deserve a mention:
  804.  
  805.    ∙ Dan Ackerman
  806.  
  807.    ∙ Mille Babic
  808.  
  809.    ∙ Stefan Becker
  810.  
  811.    ∙ Ben Bell
  812.  
  813.    ∙ Stephane Boisson
  814.  
  815.    ∙ Joe Connor
  816.  
  817.    ∙ Dieter Fiebelkorn
  818.  
  819.    ∙ Nicholas Flintham
  820.  
  821.    ∙ Stefan Haake
  822.  
  823.    ∙ Romuald Jouffrey
  824.  
  825.    ∙ Ulrich Kaiser
  826.  
  827.    ∙ Antonio Lillo
  828.  
  829.    ∙ Tim Newsome
  830.  
  831.    ∙ Fred Nicklisch
  832.  
  833.    ∙ Rosario Pignatelli
  834.  
  835.    ∙ Andrew Versperman
  836.  
  837.    ∙ Jeff Wisniewski
  838.  
  839.    ∙ Manfred Ssykor
  840.  
  841.  
  842.  
  843. 11 Possible future updates
  844. ==========================
  845.  
  846.    ∙ Further implementation of HTML3 commands
  847.  
  848.    ∙ Image loading (Double click on [IMG] text)
  849.  
  850.    ∙ ...
  851.  
  852. Please feel free to make further suggestions and constructive
  853. criticisms...
  854.  
  855.  
  856.  
  857. 12 History
  858. ==========
  859.  
  860.  *V0.8₧ (20.04.1995)*
  861.  
  862.       ∙ First release version
  863.  
  864.  *V0.9₧ (15.05.1995)*
  865.  
  866.       ∙ Reduced memory requirements
  867.  
  868.       ∙ MTOS Drag&Drop (ARGS) supported
  869.  
  870.       ∙ External programs will now run under single TOS
  871.  
  872.       ∙ Error reports are now more descriptive
  873.  
  874.       ∙ Bugfix: when running as an accessory no longer tries to
  875.         invert (non-existant) menu items
  876.  
  877.       ∙ The .INF file is now found even if HTML is not started in it
  878.         own directory
  879.  
  880.       ∙ Is now a lot more tolerant of buggy HTML file syntax.
  881.  
  882.       ∙ home.html is now loaded on startup if possible
  883.  
  884.       ∙ Hotlist
  885.  
  886.       ∙ Configuration of window and text colours etc.
  887.  
  888.       ∙ Search (including searching c't CDROM)
  889.  
  890.       ∙ In-line images can be displayed as greyscales
  891.  
  892.  *V0.93₧ (07.06.1995)*
  893.  
  894.       ∙ Preparation for on-line operation implemented (although not
  895.         activated in this version)
  896.  
  897.       ∙ Bugfix: Problem with line spacing fixed
  898.  
  899.       ∙ Bugfix: Endless loop with defective gifs fixed
  900.  
  901.       ∙ Bugfix: fclose() for Hotlist was forgotton :-(
  902.  
  903.       ∙ A few other minor bugfixes
  904.  
  905.  *V0.94₧ (07.07.1995)*
  906.  
  907.       ∙ Bugfix: Deleting the last Hotlist entry caused a crash :-(
  908.  
  909.       ∙ Bugfix: CR/LF inside tags led to problems
  910.  
  911.       ∙ Bugfix: Last word in an HTML file gobbled
  912.  
  913.       ∙ Documents access using absolute path information, including
  914.         directories listed in the 'Paths...' dialog
  915.  
  916.       ∙ Contents of a drive can be displayed as an HTML document
  917.         (including launching programs and viewing files)!
  918.  
  919.       ∙ Support for the special Netscape <CENTER> tags
  920.  
  921.  *V0.95₧ (04.08.1995)*
  922.  
  923.       ∙ Inline colour images
  924.  
  925.       ∙ Configurable image cache (in RAM)
  926.  
  927.       ∙ Configurable WWW cache (on disk)
  928.  
  929.       ∙ Option to automatically format text to the window width
  930.  
  931.       ∙ ASCII, xbm and gif files can now be viewed directly in HTML-
  932.         Browser. Calling external programs is no longer required (but
  933.         naturally still available as an option)
  934.  
  935.       ∙ Interface for 'Internet module' implemented Using a suitable
  936.         module HTML-Browser could be used to display WWW pages on-
  937.         line to the Internet, naturally you'd need an Internet
  938.         account to do this!
  939.  
  940.       ∙ Support for xbm images
  941.  
  942.  *V0.96₧ (22.08.1995)*
  943.  
  944.       ∙ Lots of minor bugfixes
  945.  
  946.  *V0.98₧ (03.10.1995)*
  947.  
  948.       ∙ In colour resolutions with fewer than 16 colours the colour
  949.         palette is no longer altered
  950.  
  951.       ∙ Zero length files should no longer cause problems
  952.  
  953.       ∙ The program is now called:
  954.         CAB - The Taxi to the information highway!
  955.         CAB = Crystal Atari Browser
  956.  
  957.  *V1.0 (01.11.1995)*
  958.  
  959.       ∙ Minor adjustments to accomodate the 3D look under Geneva
  960.         release 4 (unfortunately Geneva is not entirely MultiTOS
  961.         compatible)
  962.  
  963.       ∙ Multiple open windows may be opened
  964.  
  965.       ∙ Each window may individually configured with its own colour
  966.         and font
  967.  
  968.       ∙ Support for the following Netscape tags (commands):
  969.  
  970.          - <FONT SIZE=[+|-]n> </FONT>
  971.  
  972.          - <BASEFONT SIZE=n>
  973.  
  974.          - <CENTER> </CENTER>
  975.  
  976.          - <NOBR> </NOBR>
  977.  
  978.          - <BODY BACKGROUND=url BGCOLOR=#rrggbb TEXT=#rrggbb
  979.            LINK=#rrggbb>
  980.  
  981.       ∙ Support for the <FORM>-area (forms)
  982.  
  983.       ∙ Tables (<TABLE>...</TABLE>) are supported.
  984.  
  985.       ∙ The Hotlist dialog has been extended to accomodate themes.
  986.         Each entry can be optionally be annotated
  987.  
  988.       ∙ Cache management has been changed. Files are no longer saved
  989.         in the cache using their original names which should avoid
  990.         problems long filenames may have caused on standard TOS 8+3
  991.         character file systems
  992.  
  993.       ∙ History popup implemented
  994.  
  995.       ∙ Popup showing all links in a page
  996.  
  997.       ∙ <IMG ...> with the attribute ALIGN=LEFT or ALIGN=RIGHT now
  998.         functions correctly.
  999.  
  1000.       ∙ Font sizes in the <Hn> </Hn>-areas changed (in line with the
  1001.         method used by Netscape and Mosaic)
  1002.  
  1003.       ∙ Search now works correctly with the 92/93 c't ROM database
  1004.  
  1005.       ∙ New: Button bar in the window provides convienient access to
  1006.         most important functions.
  1007.         If a 'sad' smiley appears to the right of the button bar the
  1008.         displayed document does not conform to HTML specification.
  1009.         CAB will nevertheless try to display the document which may
  1010.         well look fine. On the other hand a 'happy' smiley does not
  1011.         indicate a perfect document because CAB does not waste
  1012.         resources analysing documents in-depth.
  1013.  
  1014.       ∙ Right aligned format (ALIGN=RIGHT) is now supported.
  1015.  
  1016.       ∙ Numerous minor bugfixes ;-)
  1017.  
  1018.  *V1.0a (12.12.1995)*
  1019.  
  1020.       ∙ Bugfix: Where available the transparent colour of background
  1021.         images is evaluated.
  1022.  
  1023.       ∙ Bugfix: In larger than 32Kb HTML files where tables are
  1024.         included after the first 32Kb garbage (maybe even crashes)
  1025.         was likely.
  1026.  
  1027.       ∙ The cursor keys can be used to scroll the window. If a form
  1028.         is depicted and the cursor is postioned in an input field the
  1029.         cursor keys can be used to navigate the form.
  1030.  
  1031.       ∙ Bugfix: Inside <PLAINTEXT> empty lines are no longer ignored.
  1032.  
  1033.       ∙ Bugfix: Under old TOS versions hard drive directories were
  1034.         not correctly evaluated.
  1035.  
  1036.       ∙ Bugfix: Under old TOS versions there were sometimes problems
  1037.         if a window title was set straight after opening a window.
  1038.  
  1039.  *V1.1a (01.04.1996)*
  1040.  
  1041.       ∙ When CAB is used offline (i.e. CAB.OVL is not installed) all
  1042.         links are sought after locally. For example an http address
  1043.         http://host/path/file would be handled as
  1044.         //localhost/path/file.
  1045.  
  1046.       ∙ When selecting the c't CD database it's now possible to use
  1047.         wildcards. For example 'K:\HTML\CT*.DAT' would find all the
  1048.         database files on all c't CDs.
  1049.  
  1050.       ∙ The closer icon now closes the window (previously this
  1051.         displayed the previous page). The previous page can still
  1052.         easily be accessed using the 'Back' button.
  1053.  
  1054.       ∙ In 640x200 (ST medium) resolution images are scaled to half
  1055.         height to maintain the correct aspect ratio (proportions).
  1056.  
  1057.       ∙ Holding down the [Shift] key when selecting a link displays
  1058.         the new page in its own window. Similarly holding down the
  1059.         [Shift] key when selecting 'OK' in the 'Open local', 'Open
  1060.         URL' and 'Hotlist' dialogs displays the new page in a
  1061.         separate window.
  1062.  
  1063.       ∙ CAB now displays the source code itself if no suitable
  1064.         external application has been installed.
  1065.  
  1066.       ∙ CAB has been extended to understand the following Netscape
  1067.         extensions:
  1068.  
  1069.          - Using the <HR> tag the WIDTH=, SIZE=, NOSHADE and ALIGN=
  1070.            attributes are evaluated.
  1071.  
  1072.          - Using <TD> and <TH> the WIDTH= and HEIGHT= attributes are
  1073.            evaluated.
  1074.  
  1075.          - Client Side Image Maps are currently partially
  1076.            implemented: <MAP NAME=name> <AREA SHAPE=rect
  1077.            COORDS="x1,y1,x2,y2" HREF=url> </MAP>
  1078.  
  1079.       ∙ Minor optimisation to handle certain boxed tables built-in.
  1080.         In principal tables should be repeatedly calculated depending
  1081.         on the width of the window and consequently such tables are
  1082.         processor intensive.
  1083.         Example: The (early 1996) FOCUS pages (www.focus.de) possess
  1084.         a boxed table with seven nested levels and these take a
  1085.         ridiculous time to calculate (e.g longer than five minutes
  1086.         for some pages!). Of the seven levels only two are used
  1087.         sensibly (the rest consist of cells containing nothing other
  1088.         than other cells (OK it may be legal but it's stupid!)). CAB
  1089.         calculates such tables as a single cell (i.e. column) which
  1090.         results in substantially faster calculation -although this
  1091.         still isn't exactly rapid it's an improvement.
  1092.  
  1093.       ∙ Any filetype which cannot be displayed by CAB itself and for
  1094.         which no application has been installed (as defined by the
  1095.         file extension) can optionally be copied to any desired
  1096.         folder.
  1097.  
  1098.       ∙ GDOS printing now possible. Currently only monochrome images
  1099.         can be output. Output via other GDOS drivers also possible,
  1100.         e.g. Metafile, IMG etc.
  1101.  
  1102.       ∙ The Hotlist dialog can now be completely keyboard controlled
  1103.         if desired.
  1104.  
  1105.       ∙ The Clipboard, Cut [Control]+X, Copy [Control]+C and Paste
  1106.         [Control]+V commands are supported in all dialog editable
  1107.         fields.
  1108.  
  1109.       ∙ The Clipboard commands are also available in document
  1110.         editable fields.
  1111.  
  1112.       ∙ The window position is now saved using the 'Save options'
  1113.         entry in the 'Options' menu.
  1114.  
  1115.       ∙ Support for new (HTML3) commands:
  1116.  
  1117.          - <BIG>, </BIG> large text
  1118.  
  1119.          - <SMALL>, </SMALL> small text
  1120.  
  1121.          - <SUP>, </SUP> Superscript
  1122.  
  1123.          - <SUB>, </SUB> Subscript
  1124.  
  1125.          - <Q>, </Q>, <LANG>, </LANG>
  1126.  
  1127.       ∙ Hotlist entries can now be completely manually created.
  1128.  
  1129.       ∙ Bugfix: HTML files with exceptionaly long comments at the
  1130.         start which didn't have use the .HTM file extender (or .html
  1131.         on systems with long filename support) were displayed as
  1132.         ASCII.
  1133.  
  1134.       ∙ Bugfix: Tables with large numbers of lines and/or columns
  1135.         caused problems.
  1136.  
  1137.       ∙ Even more tolerance built-in to accomodate HTML authors who
  1138.         invent astonishingly convoluted HTML tags -even when a simple
  1139.         HTML command already exists :-\
  1140.  
  1141.  *V1.2 (10.04.1996)*
  1142.  
  1143.       ∙ Bugfix: When memory gets short CAB will free up less urgently
  1144.         required memory (e.g. images in the cache RAM). Thanks to an
  1145.         incorrect calculation this could lead to an endless loop.
  1146.  
  1147.       ∙ Print in colour is now also possible (so long as your GDOS
  1148.         printer driver supports this).
  1149.  
  1150.       ∙ The absolute size in pixels (with tables or <HR>) are now
  1151.         converted to the existing printer resolution on printing.
  1152.  
  1153.       ∙ OLGA protocol: CAB is a OLGA client
  1154.  
  1155.       ∙ First attempt at supporting JPEG images, the file
  1156.         CAB_JPEG.OVL takes care of JPEG images and should reside in
  1157.         the CAB directory. Note: CAB.OVL is still required for on-
  1158.         line browsing, do not rename either file!
  1159.  
  1160.  *V1.3 (20.05.1996)*
  1161.  
  1162.       ∙ New JPEG module from Dieter Fiebelkorn
  1163.  
  1164.       ∙ Mail support (mailto:user@address)
  1165.  
  1166.       ∙ Proxy and SMTP-Server can be set directly from CAB (not
  1167.         applicable for local (offline) operation)
  1168.  
  1169.       ∙ A few more small bugfixes removed
  1170.  
  1171.       ∙ Unrecognised extensions ignored. For example JavaScript
  1172.         (<SCRIPT>...</SCRIPT>) is ignored and no longer displayed as
  1173.         HMTL text.
  1174.  
  1175.       ∙ 'Slide shows' via <meta http-equiv="Refresh" content="5;
  1176.         url=xyz"> now supported.
  1177.  
  1178.       ∙ <FONT> tag now supports colour (<FONT COLOR=...>)
  1179.  
  1180.       ∙ Colours in tables are now supported: BGCOLOR= for tables
  1181.         and/or cell background BORDERCOLOR=, BORDERCOLORLIGHT= and
  1182.         BORDERCOLORDARK= for the table edges
  1183.  
  1184.       ∙ The most important colour can now also be assigned by name as
  1185.         well as a hex number. For example COLOR=White instead of
  1186.         COLOR=#FFFFFF
  1187.  
  1188.       ∙ References can be followed during text formatting (the mouse
  1189.         is still not evaluated during image loading). Formatting is
  1190.         abandoned and the desired document loaded instead.
  1191.  
  1192.  
  1193.  
  1194.